home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / locdl11a.lzh / LOCALDL.DOC < prev    next >
Encoding:
Text File  |  1995-11-20  |  6.9 KB  |  150 lines

  1.  
  2.           RATSoft/ST Local Download Script v1.1a (November 20, 1995)
  3.               Written by Daniel Hedberg of New Beat Development
  4.  
  5.  
  6.  
  7.   FREEWARE NOTICE
  8.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  9.   RATSoft/ST Local Download Script is Freeware. It may be copied and used
  10.   freely. I take no responsibility whatsoever for this program, you are
  11.   entirely on your own if you intend to use it. However, I have taken
  12.   precautions in order to make it as reliable, stable and harmless as
  13.   possible and find it really hard to believe that it would be able to
  14.   destroy or mess something up.
  15.  
  16.   Despite the fact that this program is Freeware, and you have no obligations
  17.   at all towards me, I would appreciate any feedback at all. To contact me
  18.   take a look at the end of this document. Thank you!
  19.  
  20.  
  21.   OVERVIEW 
  22.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  23.   RATSoft/ST Local Download Script is a script written in RAT-Script for use
  24.   with the RATSoft/ST BBS system. It makes it possible to download marked
  25.   files by copying them to an optional path when you are in local mode.
  26.  
  27.   How many times have you been forced to exit RATSoft/ST or execute a file
  28.   copier utility just because you wanted to transfer some files from the
  29.   RATSoft/ST file areas to diskettes? Now there is a much more easier way to
  30.   do this, just install The RATSoft/ST Local Download Script on your system.
  31.   Next time you are in local mode and choose Download in the RATSoft/ST File
  32.   Sections Menu you will be prompted for a path where all the marked files
  33.   will be copied to.
  34.  
  35.  
  36.   FILES INCLUDED IN THE ARCHIVE
  37.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  38.   LOCDL11\
  39.     FILE_ID.DIZ      418 bytes         Description file for BBS systems.
  40.     INIT_LDL.SCP     860 bytes         Local Download Initialization Script.
  41.     LOCALDL.DOC    7,095 bytes         Documentation file (this file).
  42.     LOCALDL.SCP    4,777 bytes         Local Download Main Script.
  43.     UPDATES.TXT    3,318 bytes         Information about new updates.
  44.                                        
  45.   Feel free to copy this archive and its contents as long as all of the files
  46.   are included in their original directory and not modified in any way.
  47.  
  48.  
  49.   SYSTEM REQUIREMENTS
  50.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  51.   This script requires an Atari computer running RATSoft/ST v2.1 or higher
  52.   from R0dent Laboratories Software. It might also work with earlier versions
  53.   of RATSoft/ST, but there is no guarantee as it has only been fully
  54.   tested on v2.1.
  55.  
  56.  
  57.   INSTALLING AND USING THE RATSOFT/ST LOCAL DOWNLOAD SCRIPT
  58.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59.   Installing the script is very easy. Just follow the instructions below and
  60.   there should be no problems at all.
  61.   
  62.   1. Copy both the script files (LOCALDL.SCP and INIT_LDL.SCP) to your
  63.      RATSoft/ST main directory, where most of the other system files are
  64.      located. The path usually is C:\RATSOFT\.
  65.  
  66.   2. Now you need to edit the FILECMDS.DAT file (located in the RATSoft/ST
  67.      main directory) to make RATSoft/ST able to execute the script if you
  68.      are in local mode.
  69.  
  70.      The line you need to edit probably looks something like this:
  71.  
  72.      D;Download...<CR>[fd/l]
  73.  
  74.      Replace the line with this new one:
  75.  
  76.      D;Download...<CR>[~loc][exec:INIT_LDL][exec:LOCALDL][term][~lev:0][fd/l]
  77.  
  78.      The <CR> is a "Carrier Return" character (ASCII #13), you can get it on 
  79.      the screen by holding [ALTERNATE] and typing in 13 on the numerical
  80.      keyboard in the most of the available text editors.
  81.      
  82.   3. Finally you have to reload RATSoft/ST to make it aware of your changes
  83.      in the the FILECMDS.DAT file. It can be done by entering the SysOp
  84.      Commands Menu and pressing the <C> key (Re-Load Configuration)
  85.      and the <A> key. (All Files).
  86.  
  87.   Congratulations, you should now have a working copy of The RATSoft/ST Local
  88.   Download Script installed on your system. It will be executed next time you
  89.   are in local mode and chose Download in the File Sections Menu.
  90.   If you have any file(s) marked for download you will be prompted for a path
  91.   where to copy the file(s). If you select a path that does not exists, it
  92.   will be created. Press [RETURN] and the last entered path will be used.
  93.   On this screen you will also find information on how many files that are
  94.   marked and how much free space that is needed on the destination drive.
  95.   
  96.   If you select a destination drive which does not have enough free
  97.   space available you will be notified about this. This is useful if you are
  98.   copying files directly to diskettes as it is not very funny when you get
  99.   messages like "Disk full" or "Not Enough Space" after you have been waiting
  100.   for 2 minutes.
  101.  
  102.   I have also included error checking when selecting a path, so it should be
  103.   very hard (probably not impossible though) to enter an invalid path without
  104.   the script discovering it. If an invalid path is entered, you will be
  105.   notified and prompted for a new one.
  106.  
  107.   When a valid destination path have been selected a prompt will now show up
  108.   that makes it possible for you to change your mind.
  109.  
  110.     Are you sure? [Y/n/q]
  111.  
  112.   Here it is possible to select a new destination path by pressing <N>o.
  113.   <Q>uit will exit the script and take you back to RATSoft/ST. If everything
  114.   seems to be in order, try <Y>es or [RETURN] to go on.
  115.  
  116.   If the destination directory is not empty, you will end up with another
  117.   prompt:
  118.  
  119.     Warning! Destination directory is not empty.
  120.     Do you want to delete the existing file(s) in the directory? [y/N/v/q]
  121.  
  122.   If you want to delete the existing files, press <Y>es, otherwise press <N>o
  123.   or [RETURN] to continue without deleting any files. If you want to check
  124.   which the existing files are, press <V>iew, and finally <Q>uit will take 
  125.   exit the script and take you back to RATSoft/ST
  126.  
  127.   I wish you good luck with your BBS operating, and I hope this small script
  128.   will help you make the system management a little bit easier.
  129.  
  130.  
  131.   HOW TO CONTACT ME
  132.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  133.   Feel free to contact me with bug reports, suggestions, comments or any
  134.   other reasons. I can be reached in some of the following ways:
  135.  
  136.   Snail Mail:                  Internet E-Mail:
  137.   ¯¯¯¯¯¯¯¯¯¯¯                  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯ 
  138.    Daniel Hedberg               dhedberg@kuai.se
  139.    Bengtsheden 80
  140.    790 23 Svaerdsjoe           Internet Relay Chat (IRC):
  141.    SWEDEN                      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  142.                                 Nickname: _Daniel
  143.  
  144.   If you want to find out more about New Beat Development, please check out
  145.   our Word Wide Web Home Page on the Internet.
  146.     
  147.   The Home Page of New Beat Development:
  148.   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  149.    http://www.kuai.se/~dhedberg/
  150.